home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / comm / wftch119.zip / README.1ST < prev    next >
Text File  |  1996-07-21  |  9KB  |  204 lines
  1. WebFetch v1.19                                      July 21, 1996
  2. Filename : Readme.1st
  3.  
  4. For best viewing in Windows, set font to Courier New 10.
  5.  
  6. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  7. * See Install.txt for installation instructions.                *
  8. * See Feature.txt for explanation of some advanced features.    *
  9. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  10.  
  11.     Thank you very much for downloading my program and thank you 
  12. >>double<< for actually reading this very brief introduction!  I 
  13. certainly hate (as I am sure you do) wasting time reading when I
  14. could be playing with the brand-new toy that I just downloaded. 
  15. So, for my part, I will give you what you need to know as suc-
  16. cinctly as possible. On your part, please at least scan over all
  17. the items and it may save you some frustration later.
  18.  
  19.                   **********
  20.  
  21. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  22. *    First : a short commercial.  If you or your significant    *
  23. * other is a doll collector and enjoys a good deal as well as   *
  24. * friendly service, you should check out my wife's business     *
  25. * webpage.                                                      *
  26. *                 http://www.charm.net/~hdollies/               *
  27. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  28.  
  29.                 ************
  30.                 * Contents *
  31.                 ************
  32. 1. What do you need to run this program?
  33. 2. What does this program do?
  34. 3. How do you use it?
  35. 4. What does it cost?
  36. 5. Why did I write it?
  37. 6. Who am I?
  38.  
  39. 1. What do you need to run this program?
  40.    A PC with MS Windows : 
  41.    This can be Win 3.1, Win 3.11, Windows for Workgroups, or 
  42. Win95.  Personally, I haven't tested it on OS/2, but I have been
  43. told it does run.
  44.  
  45.    Vbrun300.dll (Visual Basic 3.0 runtime module) :
  46.    Check in your windows or windows/system directory.  Otherwise,
  47. you can download it from any of a number of sites incuding AOL, 
  48. Compuserve, Prodigy, Simtel, Cica, or do a search on the net for
  49. vbrun300.dll.
  50.  
  51.    A network connection : 
  52.    Either direct or an active dial-in connection.  This network 
  53. connection must support the Winsock DLL v1.1 or later calling 
  54. convention and the asynch calling features.  To date, there have
  55. been several problems reported with running WebFetch.  
  56.  
  57.    A WebBrowser :
  58.    Netscape, Mosaic, MSIE, etc is recommended, but is absolutely
  59. not required (But sure makes looking at WebPages easier).
  60.  
  61.    And, of course, some Network experience.
  62.  
  63. 2. What does this program do?
  64.    It allows the user to do two things : 
  65.    a.) Download any binary or text file that can be accessed with
  66.    a single "http" parameter.
  67.    b.) Download a webpage (*.htm, *.html) along with all the
  68.    images that are referenced in that webpage, including CGI-
  69.    generated images.  In addition, the program will edit the web-
  70.    page so that it points to the graphics files it downloaded to
  71.    your disk, not to the ones on the net.  This process can be
  72.    done "live" or in "batch" mode (see feature.txt).  After down-
  73.    loading, the webpage can then be loaded with the open file
  74.    option in your webbrowser.
  75.  
  76. 3. How do you use it?
  77.    Though I purposely designed the interface to make it as clean
  78. and as intuitive as possible, here is a short description for each
  79. field, checkbox, and button on the main form.
  80.  
  81.               -- Text Fields --
  82.    Website Name : Enter the name of the site (It is located be-
  83. tween the "http://" and the first "/" in the webpage reference).
  84. OR you can copy and paste in the whole address, click on the name,
  85. and WebFetch will place the right information in the Website name
  86. and URL name itself.
  87. NOTE: to copy and paste in WebFetch, you can use the standard
  88. Windows Powerkeys (Ctrl-Insert to copy, shift-Insert to paste).
  89.  
  90.    URL Name : Includes everything (including the filename) after
  91. the name of the site.
  92.  
  93.    D/L Name : The complete pathname of where you want to save the
  94. file.  If you have selected the "Download Referenced Graphics
  95. Files" option (see below), the graphics files will be downloaded
  96. into the same directory as the webpage.
  97.  
  98.               -- CheckBoxes --
  99.    "Download Referenced Graphics Files" Option - Select this when
  100. you are downloading a webpage (*.htm, *.html) and you wish to
  101. download the referenced graphics files.  Otherwise, unselect it.
  102.  
  103.    "Strip HTTP Comments" Option - Suffice it to say, you are best
  104. to leave this checked.  Some sights send header information that
  105. would corrupt any binary files (including the graphics files)
  106. that Web Fetch downloads.  On the other hand, if you are down-
  107. loading webpages to see how they are put together, it may be use-
  108. ful to see that header information, so you can unselect it. 
  109.  
  110.    "Overwrite" Option - Will overwrite existing files 
  111. with the same name as it is saving.  Unselecting this option will
  112. have WebFetch ask permission to overwrite before overwriting
  113. existing files.
  114.  
  115.    "Skip" Option - Does the opposite of the "Overwrite" option -
  116. it will skip downloading any files that already exist.
  117.  
  118.                -- Buttons --
  119.    "Auto Req..." Button  - Prompts you for a command file name.
  120. See the Feature.txt file for explanation of Auto feature.
  121.  
  122.    "Send Req..." Button  - Clicking here starts the download
  123. process.
  124.  
  125.    "Cancel All" Button   - Cancels all pending file downloads. 
  126.     
  127.    "Cancel File" Buttom  - Cancels current file download only.
  128.  
  129.    "Exit Program" Button - Stops any download and exits the program.
  130.  
  131.    "..." Button - Brings up a file dialog box for selecting Down-
  132. load filename.
  133.  
  134.    "C" Button - This button opens a configuration screen that
  135. allows you change the defaults and save them on just about every-
  136. thing useful.
  137.  
  138. 4. What does it cost?
  139.         Nothing - it is freeware.  I consider that the use of
  140. this program is my gift to the internet community at large as a
  141. way of saying _thank you_ for all the useful files and informa-
  142. tion I have gotten over the years.  There will probably be some
  143. additional updates to either correct a problem or to adapt to
  144. the ever-changing world of HTML.
  145.         Currently, I have no plans to release the source code for
  146. the public.
  147.         All that I ask is that if you like it, find it useful,
  148. have suggestions or inquiries, or want to be notified of any
  149. program updates, drop me an email message at :
  150.        Jim Borror <hdollies@charm.net>.  
  151.  
  152. Oh, and please read the disclaimer below.
  153.  
  154. 5. Why did I write it?
  155.         I wrote it for myself.  When I was teaching myself about
  156. webpages,  I found two problems.  First, I wanted to see how
  157. different webpages were put together, and second, I didn't want
  158. to tie my webbrowser up with a 20 minute download.  Having the
  159. graphics files local to my disk made that a lot easier.  This
  160. program made all that possible.
  161.  
  162. 6. Who am I?
  163.         Jim Borror, hdollies@charm.net.  I am a computer program-
  164. mer specializing in graphics, network, and web apps (HTML, CGI,
  165. and now Java).    
  166.  
  167. Disclaimer :
  168. I make no representations about the suitability of this software
  169. or about any content or information made accessible by the soft-
  170. ware, for any purpose.  The software is provided 'as is' without
  171. express or implied warranties, including warranties of Merchant-
  172. ability and fitness for a particular purpose or noninfringement.
  173. This software is provided gratuitously and, accordingly, I shall
  174. not be liable under any theory or any damages suffered by you or
  175. any user of the software.  I will not support this software.  
  176.         All content accessed through the software is the property
  177. of the applicable content owner and may be protected by applica-
  178. ble copyright law.  This license gives you no rights to such
  179. content.  Title, ownership rights, and intellectual property
  180. rights in and to the software shall remain with me.  You agree
  181. to abide by the copyright law and all other applicable laws of
  182. the United States including, but not limited to, export control
  183. laws.
  184.     I shall not be liable for (a) incidental, consequential,
  185. special or indirect damages of any sort, whether arising in tort,
  186. contract o